home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / dev / mui / MCC_Popph.readme < prev    next >
Encoding:
Text File  |  2000-05-03  |  9.0 KB  |  215 lines
  1. Short:    V15.5 - Popup placeholder class (MUI)
  2. Author:   Marcin Orlowski <carlos@amiga.com.pl>
  3. Uploader: Marcin Orlowski <carlos@amiga.com.pl>
  4. Version:  15.5
  5. Type:     dev/mui
  6. Replaces: dev/mui/MCC_Popph.*
  7. Www:      http://amiga.com.pl/mcc/
  8. Source:   dev/mui/MCC_Popph_Src.lha
  9.  
  10.  
  11.   Short
  12.   -----------------------------------
  13.  
  14.   Popplaceholder class is a simple but useful class ;) Most applications
  15.   are fully configurable nowadays, offering wide range of various
  16.   parameters for further user modifications.  Not only functions options
  17.   or forms of behaviour are configurable but often most of program
  18.   strings can now be changed by the user.  The latter applies to
  19.   internet (communication) related programs mostly, (e.g.  AmIRC,
  20.   AmTelnet, YAM and so on...) which needs to send various string to
  21.   other different people.  So they allow you to define e.g.  own welcome
  22.   phrase or kick reason sentence.  Because e.g.  your welcome phrase for
  23.   e.g.  John and phrase for Mary will differ only with the name, most of
  24.   these strings uses so called placeholders, to describe varable,
  25.   dynamically modified string part (e.g.  mentioned receipient name).
  26.   For example "On %d, %u wrote:".  The "%d" and "%u" ares just the
  27.   placeholders, program will replace on use by for instance mail date
  28.   and the sender's name (of course placeholder can look like "@name" or
  29.   "%{date}" or "my lovely grandma", but the idea behind remains).
  30.  
  31.   Unfortunately, most programs forces user to know what placeholder can
  32.   be user where and which means what.  That's kinda user unfriendly
  33.   (especially for beginners, or just-users).  Instead of forcing them to
  34.   type placeholders by hand (in proper syntax!) it would be nicer to let
  35.   them pick up what they want from the list of available items.  That
  36.   both eliminates placeholder syntax problems (unless user 'fix' it
  37.   later by hand of course) as well as disallows to use unsupported
  38.   placeholder (the above exception applies of course).  And here comes
  39.   Popplaceholder class.  It features the ordinary string gadget user can
  40.   type own text in, but it also gives the popup listview, which holds
  41.   all available placeholders.  User can easily select one from the list
  42.   either by double click or by neat Drag&Drop.  See the example demo
  43.   program for better picture of the class' features.
  44.  
  45.  
  46.   Popplaceholder is freeware software, but it's copyrighted
  47.   © 1999 by Marcin Orlowski <carlos@amiga.com.pl>
  48.  
  49.   PS: Yes, I know my english sucks ;)
  50.  
  51.  
  52.   Software using this class:
  53.   -----------------------------------
  54.  
  55.   - AmIRC 3
  56.   - AmTelnet 2
  57.   - OpenURL 3
  58.   - Voyager 3
  59.  
  60.   Let me know about your!
  61.  
  62.  
  63.   History
  64.   -----------------------------------
  65.  
  66.   14.0 (Mon Jul 12 10:15:34 1999)
  67.        - initial version
  68.  
  69.   14.1 (Mon Jul 12 13:09:21 1999)
  70.        - Added MUIA_Poplaceholder_Copy attribute
  71.        - now forwards all list object methods
  72.          to internal pop up list, increasing
  73.          flexibility
  74.  
  75.   14.2 (Tue Jul 13 19:35:58 1999)
  76.        - shortened all these "MUIx_Popplaceholder_#?"
  77.          to "MUIx_Popph_#?" for easier programming ;)
  78.        - added Drag&Drop feature
  79.  
  80.   14.3 (Wed Jul 14 14:05:34 1999)
  81.        - first public release
  82.        - wrote autodocs
  83.        - added support for existing string gadget
  84.          replacements (the fallback scheme looks like:
  85.          Textinput -> Betterstring -> original String)
  86.        - MUIA_Popph_StringMaxLen is gettable now
  87.  
  88.   14.4 (oops, I forgot the datestamp)
  89.        - added support for popup menu when Textinput
  90.          subclass is used
  91.        - added MUIA_Popph_ReplaceMode attribute
  92.  
  93.   14.5 (Sun Jul 25 19:58:25 1999)
  94.        - Popplaceholder is now 2-in-1 custom class
  95.          (poplaceholderstr.mcc is now useless and
  96.          should be wiped out of your disks)
  97.        - added some internal checks to avoid possible
  98.          problems with tag/descriptions being longer
  99.          than predefined max length
  100.        - Popph object is no longer higher than highest
  101.          object it uses
  102.        - MUIA_Popph_StringType added
  103.        - all TI/BS/String attrubutes are now forwarded
  104.          to internal string object on OM_SET/OM_GET.
  105.          Just talk to Popph as to string gadget
  106.        - added PopAsl alike work mode
  107.  
  108.   14.6 (Tue Jul 27 16:09:44 1999)
  109.        - MUIA_Version, MUIA_Revision are now supported
  110.        - fixed bad enforcer hit "implemented" in 14.5
  111.        - MUIA_Popph_Avoid added
  112.        - added MUIA_Popph_StringObject, MUIA_Popph_ListObject
  113.  
  114.   14.7 (Tue Aug 31 10:28:35 1999)
  115.        - all list methods and attributes are now forwarded
  116.          to internal list object. Handle with care.
  117.        - public release
  118.  
  119.   15.0 (Sat Nov 06 17:32:28 1999)
  120.        - now handles the entry even it's incorrect (e.g.
  121.          plain string, w/o separators etc) for easier
  122.          debugging (and wider usage ;-)
  123.        - added MUIA_Popph_PopCycleChain attribute on
  124.          mouse lovers' request (reported by Grzegorz Kraszewski)
  125.        - PopPH now correctly handles ASLFR_DrawersOnly, TRUE
  126.          case in ASL mode (reported by Troels Walsted Hansen)
  127.        - added MUIA_Popph_Title for easy popup list titles
  128.        - added single column mode
  129.  
  130.   15.1 (Tue Nov 23 23:25:45 1999) - sponsored by Thorgal ;-)
  131.        - fixed MUIA_Popph_Avoid not working correctly
  132.          (Mike Carter)
  133.        - pop buttons removed from the cycle chain
  134.          (MUIA_Popph_PopCycleChain is now FALSE by default)
  135.          as MUI offers special hotkey (CTRL-P by default)
  136.          for that, and won't break the AdvanceOnCR adventages
  137.          (reported by Grzegorz Kraszewski)
  138.        - full source code released. Read source.readme for
  139.          closer details
  140.  
  141.   15.2 (Sat Nov 27 14:47:34 1999) - sponsored by Thorgal ;-)
  142.        - attached popup listview to the string object, to
  143.          allow key-driven list navigation (Carlos) (reported
  144.          by Mike Carter)
  145.        - now uses all string/list related tags given at
  146.          Popph creation time while creating internal string
  147.          nd list object, to allow use of {I..} attributes
  148.          as well (Carlos) (reported by Mike Carter)
  149.  
  150.   15.3 (Wed Feb 02 22:53:00 2000) - sponsored by The Hun
  151.        - some attributes were wrongly DoSuperMethod()ed in
  152.          OM_GET (Zapek)
  153.        - fixed bugs when MUI_NewObject()ing without attributes
  154.          (Zapek)
  155.  
  156.   15.4 (Sun Feb 06 18:56:00 2000) - sponsored by HardcoreJunky
  157.        - MUI_DeleteCustomClass() was called with a freed pointer
  158.          thus nuking when mungwall was running (Zapek)
  159.        - public release
  160.  
  161.  
  162.  
  163.           ___  ___  ___    ________    ___  ___  ___    ___  ___
  164.          /   \/   \/   \  /        \  /   \/   \/   \  /   \/   \
  165.         /    /    /    / /         / /    /    /    / /    /    /
  166.        /    /    /    / /    _____/ /    /    /    / /    /    /
  167.       /    /    /    / /        \  /    /    /    / /         /
  168.      /    /    /    / /         / /    /    /    / /         /
  169.     /    /    /    / /    _____/ /    /    /    / /    /    /
  170.    /    /    /    / /    /      /    /    /    / /    /    /
  171.    \___/\___/\___/ /    /       \___/\___/\___/  \___/\___/
  172.                   /    /
  173.                   \___/                    W.F.M.H. on-line
  174.                                          http://wfmh.org.pl
  175.  
  176.                Amiga software: http://amiga.com.pl/
  177.  
  178.  
  179.    $Id: MCC_Popph.readme,v 1.7 2000/02/06 18:07:37 zapek Exp $
  180.  
  181.  
  182. ============================= Archive contents =============================
  183.  
  184. Original  Packed Ratio    Date     Time    Name
  185. -------- ------- ----- --------- --------  -------------
  186.     1188     742 37.5% 31-Aug-99 10:32:18  mcc_popph.info
  187.    11576    7365 36.3% 02-May-96 09:55:08 +WrapGuide
  188.     1192     660 44.6% 14-Jul-99 16:42:16 +Demos.info
  189.    10472    6563 37.3% 06-Nov-99 23:12:20 +popph_demo
  190.     1654     900 45.5% 14-Jul-99 16:42:16 +PopPH_Demo.info
  191.    16911    5565 67.0% 04-Apr-00 17:58:24 +mcc_popplaceholder.doc
  192.     6206    1657 73.3% 06-Nov-99 23:10:40 +popph_demo.c
  193.     4385    1124 74.3% 04-Apr-00 17:58:24 +popplaceholder_mcc.h
  194.     1233     767 37.7% 14-Jul-99 16:43:06 +Install.info
  195.     2418    1523 37.0% 14-Jul-99 16:43:06 +Dansk.info
  196.     2420    1537 36.4% 14-Jul-99 16:43:06 +Deutsch.info
  197.     2420    1550 35.9% 14-Jul-99 16:43:06 +English.info
  198.     2421    1529 36.8% 14-Jul-99 16:43:06 +Français.info
  199.     2491    1559 37.4% 14-Jul-99 16:43:06 +Greek.info
  200.     2421    1548 36.0% 14-Jul-99 16:43:06 +Italiano.info
  201.     2423    1525 37.0% 14-Jul-99 16:43:06 +Nederlands.info
  202.     2419    1543 36.2% 14-Jul-99 16:43:06 +Polski.info
  203.     2411    1506 37.5% 14-Jul-99 16:43:06 +Russian.info
  204.     2481    1565 36.9% 14-Jul-99 16:43:06 +Srpski.info
  205.     2480    1556 37.2% 14-Jul-99 16:43:06 +Suomi.info
  206.     2420    1520 37.1% 14-Jul-99 16:43:06 +Svenska.info
  207.     2482    1592 35.8% 14-Jul-99 16:43:06 +ÃeÓtina.info
  208.     9824    5522 43.7% 04-Apr-00 17:58:24 +Popplaceholder.mcc
  209.   139518   28059 79.8% 03-Jan-98 16:41:34 +MCC-Install
  210.     2694    1585 41.1% 14-Jul-99 16:29:00 +MCC-Install.info
  211.     7339    3031 58.7% 04-Apr-00 17:58:24 +MCC_Popph.readme
  212.     1391     683 50.8% 14-Jul-99 16:27:20 +MCC_Popph.readme.info
  213. -------- ------- ----- --------- --------
  214.   247290   84276 65.9% 06-Apr-100 21:44:20   27 files
  215.